V_FILENAME()
 Return the file name of a file opened in a specified area
-------------------------------------------------------------------------------

 Syntax

    V_FILENAME( [<nArea> | <cAlias>] )    ->    cFileName

 Arguments

    <nArea> or <cAlias> refers to the number or name of the target DBV
    work area.  If not specified, V_FILENAME() returns the file name
    from the currently selected DBV work area.

 Returns

    V_FILENAME() returns the DOS file name of the DBV file opened in
    the specified area.  If no file is open in the specified area,
    V_FILENAME() returns a null string ( "" ).

 Description

    V_FILENAME() is used to retrieve the DOS file name that refers to
    the DBV file. This name will not include the drive or path
    designators.

    This function is provided specifically for debugging where it is
    sometimes insufficient to only have access to the alias.

 Examples

    // Show the name of the file (not the alias)
    V_SELECT(1)
    V_USE( "pic_file.dbv", "pictures" )

    ? V_FILENAME()        //  Returns: PIC_FILE.DBV
    ? V_ALIAS()           //  Returns: PICTURES

    V_SELECT(2)
    ? V_FILENAME( "PICTURES" )//  Returns: PIC_FILE.DBV